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AN ACTIVEMARK MECHANISM IN A LIVE PARSING EDITOR 



ABSTRACT OF THE D IS CLOSURE 

An activemark mechanism for a live parsing editor, The aetivemark mechanism 
allows marks (labels) In text to be referenced or linked to any editor command, macro, or any 
external tool activated by the editor. The activemark mechanism comprises a parsing mechanism 
which creates an aetivemark automatically when the document is loaded in the editor, and thereafter 
as a user enters information into the document by parsing the changes to the document as they are 
committed. The activemarks are dynamic in thai their meaning and behaviour are updated in the 
context of any external tool which is activated by the editor. 
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AN ACTIVEMARK MECHANISM IN A LIVE PARSING EDITOR 

FIELD OF THE INVENTION 

The present invention relates to document processing for a data processing system. 
More particularly, the present invention relates to aaaclivemark mechanism for a live parsing editor, 

5 BACKGROUND OF THE INVENTION 

The concept of a mark is used iai document processing systems, such as editors, to 
denote a label structure. In an editor, marks are typically used for setting bookmarks in the text and 
labelling text which is referenced by other tools, for example, source code which is referenced by 
compiler error messages, in the context of browsers for Internet applications, marks denote 
1 0 "hypertext" links, or are used to invoke a function such as an applet 

The conventional concepts of "mark" and "hypertext" are restrictive in their 
definitions and, as a consequence, have limited functionality in the context of today's data 
processing systems. Conventional mark aid hypertext structures are static in both location and type, 
and comprise a tag which is hard-coded in the source file. Beyond responding to the click of a 
15 mouse, conventional mark and hypertext structures offer no real interactivity. 

What is needed is a mechanism for "aetivemarks" which are dynamically set in a 
document using a programmable editor, and which provide the capability to dynamically link any 
pieces of text or locations in the edit view to any editor, or external, command, 

MmmMmjmjmmiwx 

20 The present invention provides an activemark mechanism for editors and other 

document processing systems. The activemark structure features the capability to bind commands 
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to the mark. The activemark structure utilizes a parsing mechanism which creates activemarks 
automatical !y as the user opens a document, and thereafter as the user enters information into the 
document, by incrementally passing changes io the document. The activemark mechanism is 
particularly applicable to programmable text editors or edit controls such as the IBM Live Parsing 
5 Extensible Editor (LPEX). 



According to one aspect, the activemark mechanism provides the capability to link 
any piece of text, with any editor command or macro, or via the editor to any external command, for 
example, editor-attached tools, system commands, and the like. Advantageously, the activemark 
mechanism is not limited to hard-coded labels in specifically-tagged source text, nor is the 
1 0 activemark mechanism limited to hard-coded functionality, such as relocation finks, references, or 
running an applet. The activemarks and their definition and behaviour are updated in the contest 
of any external tool which is activated by the live parser. 



According to another aspect, the binding of the activemark to a command does not 
need to he specified in the source file which is loaded in the editor. Furthermore, the document 

15 remains intact regardless of the activemarks which may be set throughout the edit session. 
According to the invention, the mark is set over, or linked to, a particular piece of text by a live 
parser and/or other external command(s) running off the editor, rather than being hard-coded in the 
text. Activemarks and their associated comrnand(s) may also be set during the edit session by the 
user either manually, i.e. directly through the GUI (Graphical User Interface), or through 

20 actions/tools provided by the GUI. 

The activemarks-setting (or acttvefiurkirig) operation is first performed during the 
initial loading of a file in the editor during total parse, and thereafter, incrementally as triggered by 
user changes, or other operations, to the file. During the processing of a file, the activemarks are 
kept synchronized with the text being edited. 
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U is a feature of the aetivemark mechanism thai the links ate not necessarily static in 
type. The activemarks and their meaning or behaviour upon activation are updated in the context 
of any external tool activated by the live parser. For example, a source-code navigator will 
dynamically update the caller and caliee references between marks set on the function headers and 
5 on the function calls. 

A Hypertext Markup Language (HTML) editor (e.g. in an Internet browser) for 
HTML files implementing the aetivemark mechanism according to the present invention includes 
the functionality already supported for HTML files and their hard-coded and unique- command 
markup tags in addition to the features of the aetivemark mechanism. This editor may be, however, 
1 0 programmed to encode acti vemarks set up during fee edit session as hard-coded tags in the document 
rile, 

According to another aspect, activemarks can be programmed to display in various 
ways, such as through highlighted fonts defined through foreground and background colours and 
* s* attrH „t s{e.j s' lies, bold, underscore, etc.), borders, bitmaps, etc., or drawn under control of 
15 the externa! command, Activemarks may also be programmed to display in a position in the edit 
view different from the location of the test associated with them. 

In one aspect, the present invention provides a processing system for processing a 
document, the processing system comprises: (a) a programmable text processing module having 
means for loading the document and a parsing editor for initially parsing the document and thereafter 
20 incrementally parsing changes committed in the document (b) a mark control module having means 
for setting a plurality of marks in the document, means for modifying the marks, and means for 
clearing the marks, and each of the marks comprising selected information in the document and 
means for linking the selected information with a command, the linking means being responsive to 
the operation of the parsing editor; (c) a graphical user interface module having means for displaying 
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the document and means for controlling the display of the document; (d) an edit control module 
having means for controlling the text processing module, means for controlling the mark control 
module, and means for controlling the graphical user interface module. 

In another aspect, the present invention provides in a document processing system 
5 having means for loading and storing a document, a parsing editor for initially parsing the document 
and thereafter incrementally parsing information entered in the document, and a graphical user 
interface for displaying the document, a method for generating marks in the document, the method 
comprises the steps of: (a) selecting information for a mark in the document; (b) linking the selected 
information to a command, the linking operation being responsive to the parsing by the parsing 
1 0 editor; (c) activating the mark in response to an activation input. 

BRIEF jQ ESCMQIONO F THEJDRAV Q^iGS, 

Reference will now he made to the accompanying drawings which show, by way of 
example, preferred embodiments of the present invention, and in which: 

Fig, i is a block diagram of an edit system incorporating an activemark structure and 
1 5 live parsing mechanism according to the present invention; 

Fig, 2 is a schematic representation of a source file document opened in the edit 

system; 

Fig. 3 is a diagrammatic representation of a view opened in the edit system by 
activating an activemark from the source file document of Fig. 2; 
20 Fig, 4 is a diagrammatic representation of the acti vemarks set in a subsequent source 

view opened by the activation of the activemark front the source file document of Fig, 2; and 

Fig, 5 is a diagrammatic representation of the commands bound to the activemark of 
Fig, 3 shown in a view pop-up screen which has been activated. 
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DETAILED D ESCRIPTI ON, OF THE INVENTION 

Reference is first made to Fig. 1 which shows in block diagram form an edit system 
1 0 for implementing an aciivemark mechanism according to the present invention. In the following 
description, the terms editor and edit system are used in a general sense to refer to any system to 
5 which this invention applies, be it a text editor, text processor, Internet browser, etc, 

Referring to Fig. 1, the edit system 10 comprises the following principal functional 
modules: an edit control module I i, a test processing module 12 f an activemarks module 13, a 
graphical user interface (GUI) control module 14, and a commands/macro interface module 15. 
During the editing of a document, the editor 1 0 maintains a series of data structures which include 
1 0 an edit control data structure 2 1 , a document control data structure 22, an edit buffer 23 , zero or more 
activemark data structures 26, and one or more view control data structures 27. As shown in Fig. 
1 , the edit buffer 23 comprises one or more element data structures 25, shown individually as 25a 
and 25b, 

The edit control module 1 1 is responsible for the instantiation and management of 
1 5 the various components of the edit system 10. The functions of the edit control module 1 5 include 
processing internal edit system commands, handling the binding of internal commands or external 
commands and edit macros to menu items, key actions, mouse actions, etc, When an action is 
received, the edit control module 1 1 invokes the command, if any, bound to the action. 

The text processing module 12 handles the loading of documents into the edit buffer 
20 23 of the edit system 10. The functions of the test processing module 12 also include text editing 
operations and the formatting of the text, and the saving of the documents. The text processing 
module 12 records committed changes to the document in a stack for subsequent processing by a live 
parser which is registered in the edit system 10 for die document. The activemarks module 13 is 
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called to respond to the changes in the text, such as to adjust the aetivemarks to newly-changed text 
and to invoke exit points of aetivemarks affected by alterations to the document text. 

The aetivemarks module 13 handles the processing of marks and aetivemarks 
including setting, clearing, changes to the marks resulting from modification to the text, setting and 
5 activation of activemafk commands and exit points. The functions of the aetivemarks module 13 
are described in more detail below. 

The principal functions of the graphical user interface control module 14 include 
controlling the document edit view control, and building and rendering the edit view, The graphical 
user interface module 14 nonages the display attributes of the rendered elements as set up by the 
10 editor and its attached tools, for example, those set by the tokenization and cobrization of the text 
by the live parsers), non-document display-only elements and imbedded messages, the display 
attributes of aetivemarks, etc. Preferably, the graphical user interface control module 14 includes 
the capability to show the contents of the edit buffer 23, i.e. the document, selectively by only 
including in the view those elements whose visibility matches the current settings, 

15 The functions of the commands/maa : t face module 15 include control - u 

interface to internal and external commands and edit macros, including live, incremental, parsers. 
The commands/macros interface module 15 also loads and runs external commands and macros. 

The edit control data structure 21 comprises a data structure which stores global data 
for controlling the edit system 3 0. lite document control structure 22 stores document control data 
20 for controlling the operations on a document in the ed it system 10. During the course of operation, 
several document controls will be created, one for each document. 
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The edit buffer 23 comprises a Jinked list of all the text elements which make up a 
particular document For a document, classes are defined which broadly classify element types in 
the document. Classes are used to filter out elements from the view, and are also used by the parsers 
or external commands to interpret She edit buffer (i.e. the document) contents at various degree of 
5 detail. Each element can belong to one or more classes. 

The element data structure 25 stores ihs text elements and the corresponding prefix 
area contents. In addition, the element data structure 25 contains formatting flags and display 
attributes and class information. The contents of a document comprise text elements which are 
loaded into the edit system 10. The display attributes for each character are usually set by the 
1 0 tokenizer in a live parser attached to the edit system 1 0. 

The view control data structure 27 contains data related to the control of an edit view 
for one document in an edit system window. Such view control data includes display attributes 
defined for the view, the size of the view, the format of its displayed prefix area(s), the required 
visibility of elements (for filtering, e.g., zooming in/out of text), screen fields for the document view 
1 5 consisting of the particular area of the Edit Buffer that displays, etc. 

The activemark data structure 26 contains the data associated with the activemark 
definitions. As will now be described, the activemark mechanism according to the present invention 
allows the Jinking or binding of any piece of text in fee document with any editor command or 
macro, it is a feature of the acti vemark mechanism thai the binding of the activemark to a command 
20 is not specified in the source file (i.e. the document) loaded in the edit system 1 0. Instead of being 
"hard-coded" in the text of the document, the activemark according to the invention is set over a 
particular piece of text by a live parser and/or other externa! command(s) running in the edit system 
1 0. As will be described in more detail below, the binding of the activemark is performed first upon 
the initial loading of a document file in the edit system 30 during the loud passe operation, and 
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subsequently in response to user-entered changes or to oilier operations performed on the file. 
During the processing of the document file, the edit system 1 0 keeps the activemark(s) synchronized 
with the text being edited ir. the document. As will be described in mo eS il I activemark 
mechanism also provides the capability to program the display of the activemarks in the document. 

5 One or more live parsers) may be attached to the edit system 10 for a document. A 

parser first gets control after the file has been loaded into the edit system 1 0 (i.e. initial total parse), 
and thereafter it is called by the text processing module i 2 following changes made to the document 
(i.e. incremental parse), The live parser, which is typically an external command, parses the edit 
document, The live parser sets display attributes for Lhe text elements in the edit view according to 

10 the syntax of the document (e.g, token highlighting), records classes in the edit system 10 with 
information regarding various constructs found in the document (e.g. C-ianguage function bodies), 
and sets up activemarks accordingly. The parser-set information is used by the edit system 10 to 
display the document in a view (e.g. colourized, filtered section of the source, activemark labels, 
etc.), by other tools attached to the edit system to obtain detailed information about the structure of 

15 the document in order to carry out context-sensitive actions, and by the parser itself as reference 
points for incremental parsing. 

The activemark mechanism according to the present invention comprises a SET 
MARK. ACTION command, a QUERY MARK-ACTION command, and a MARK RUN command. 
A user utilizes the SET MARK.COMMAND command to turn a conventional mark into an 
20 activemark, i.e, set the command binding of a mark. It will be appreciated that as such conventional 
marks in the edit system 10 are a subset of activemarks. 

The user utilizes the QUERY MARK.COMMAND command to determine which 
command(s) are bound to an activemark. The MARK RUN command is used to activate the 
command that is associated with the activemark. 

8 
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An activemark is triggered, or invoked, either through an explicit command request 
or through a command bound to a particular key or key combination, for example, clicking a mouse 
button as described below with reference to Figs. 4 and 5, 

In response to selection of a particular key {or key combination), the activemarks 
5 module 13 in the edit system 10 wili rat! the command(s) which are bound to the activemark(s) 
indicated. The editor or live parser profile may bind a particular key to the MARK RUN command, 
such as a left mouse button single click. When the user activates the activemark (that is, selects the 
key combination bound to the MARK RUN command), the command for the activemark modifies 
the mark's highlight font for visual feedback purposes, and carries out the bound command(s). 
1 0 Typically, such a selection key is bound to & generic activemark trigger command or macro, which 
will handle the activation of the activemark(s) at the active point in a uniform maimer, and take the 
most appropriate action in the case there are overlapping marks at the current selection location, i.e. 
invoke the command of the top-most mark, or that spanning the smallest range of text selection, or 
present the user with a choice, etc. 

1 5 Similarly, as an example, the mark-setting tools {e.g. editor macros) may register & 

callback for the initialization of the pop-up screen. When the pop-op menu is brought up, each tool 
is called to optionally add one or more appropriate menu itemfs) for any of its activemarks that are 
set at the pop-up activation location. 

Tools that are added/removed during the edit session will, through the QUERY and 
20 SET MARK.COMMAND commands, add to and restore an existing activemark command or series 
of commands, and similarly register and de-register the callbacks for the pop-up initialization. 

Reference is next made to Figs. 2 to 5 which show a series of screen displays for a 
sample document in an edit, system incorporating the activemark mechanism according to the present 
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invention. In this example, the sample document as depicted in Fig, 2 comprises a source code 
computer program 100 written in the well-known C-prcgrammirig language. As shown in Fig. 2, 
the source code program 100 has been loaded in the edit system 10 and is displayed in a window 
101, The program file {i.e. document) 100 has been processed, i.e. parsed, by a live parser for C 
5 which is attached to the edit system 10. The initial processing by the live parser comprises the 
following operations: registering itself to the edit system 10 for incremental parsing; adding its own 
menu items for C-related user actions; tokenizing and colourizing the document 100 according to 
C-programming syntax and conventions; setting up an activemark For each function in the program 
module; and collapsing the view in the window 101 to only show the function headers for the source 
10 code program 100. 

As shown in Fig. 2, the activemark for each function is displayed as a presentation 
label 1 10, The presentation labels ! 10, denoted individually as 1 10a, 110b, 1 10c, HOd, HOe,..., 
1 1 On, are set outside the associated text (i.e. the function names in the function headers) in the source 
code 1 00 and aligned on the right side of the window 1 0 1 . The view of the source code program 1 00 
1 5 shown in the window 1 0 1 serves as a function-level overview of the contents of the source code 
program 1 00, and provides a starting point for editing operations in the source code program 1 00, 
Preferably, the live parser sets the activemarks and associated commands in the various windows 
such that the same action trigger, e.g. clicking or double clicking the left mouse button, invokes the 
action which is most natural and expected by the user in the particular context. 

20 In operation, the live parser is continuously triggered in response to editing operations 

on the source code program 100 to keep the file tokenizaiion current, and to add or remove 
activemarks as functions are added or removed from the source code 100. The commands associated 
with the activemarks in the window 10! shown m Fig. 2 are set to call a function in the live parser 
which opens a source function-navigator window 103 as shown in Fig. 3 and runs the commands 

25 associated with the particular activemark which has been activated. This feature serves to effectively 
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chain activemarks in different windows {or ieveis of abstraction of the same source code) in the edit 
system 10, 

For example referring back, to Fig. 2, the user has clicked the label 1 IOi associated 
with the activemark for the function parseCurrentO . The commands associated with the activemark 
5 11 Oi for the function parseCurrentO include a command to highlight the presentation label 1 1 01 (as 
shown in Fig. 2), a command to open the function navigator window 103 as shown In Fig. 3, and a 
command to run the activemark for the parseOurreniQ node in this window. As sho wn in Fig. 3, the 
activemark for the function parseCurrentO is run as if directly activated by the user, i.e. the 
activemark is displayed as a highlighted label 1 12i, and causes the system 10 to display a new edit 
10 view 105 for the function parseCurrentO as shown in Fig. 4. 

As shown in Fig. 4 } the source code segment associated with the activemark for the 
function parseCurrentO is displayed in the edit view window 105, the code is tokenized by the C- 
language parser, and activemarks art set over the body of the function parseCurrentO (denoted by 
reference 123) and each variable accessed in this function (denoted by reference 1 20). Referring to 

15 Fig, 4, activemarks 320 and 123 are shown highlighted in relation to the rest of the text for 
explanatory purposes, and are not necessarily so highlighted by the parser. The variables in function 
parseCurrentO set as activemarks S20 include insideComment 120a, wascomment 120b s rc 320c, 
and fPeadOff 1 20d, Mo ving the mouse pointer in this view over the variable activemarks 1 20 causes 
the command associated with the particular activemark 120 to display information about that 

20 variable in the message line 1 06 of the edit view window f 05. The information associated with the 
activemarks about a certain item or segment of the source document, e.g. variable IPendOff 120d, 
can be queried and used by other tools attached to the edit system 1 0. 

When the user activates the view pop-up over overlapping activemarks, the actions 
of all the activemarks at that location are displayed. Referring to Fig. 5, the available user actions 
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associated with any of the activemarks 120 and 121 are displayed in a pop-up window 107. The 
pop-up window 107 is displayed by clicking, for example, the right button on the mouse with the 
mouse pointer positioned over the activemark 120 of interest. For example, the right button of the 
mouse is clicked with the pointer over the activemark for fPendOff I20d to display a. pop-up wi ndow 
5 I07dwith the actions associated with the variable 1 20d and function parseCurrent() 121. As shown 
in Fig, 5 S die actions associated with the IPendOff activemark 120d comprise an object 122a for 
opening a view of the file where this external variable is declared, an object 1 22b for displaying a 
list of the functions called from parseCunenlQ, and an object 122c for displaying a list of the 
function calls to parseCurrentQ. Clicking one of the objects in these lists initiates other appropriate 
10 editing operations. 

As another example, an interactive demo of an application, or interactive navigation 
through a document, may be set through an appropriate source file in conjunction with a live parser 
and text formatter that interpret the text as menu items, tables of contents, references to external 
commands, system utilities, etc. 

1 5 The activemark mechanism is implemented in the form of several data structures or 

control blocks. The control blocks maintain information about the activemarks in the edit system 
10. As will now be described certain mark-related information is part of other control blocks in the 
edit system 1 0 in order to facilitate handling fee marks in the context of the edit session. 

The mala data structure or control block for an activemark takes the following form: 

20 

mark control block 



epl - start of mark: pointer to text element cb {control block? , 
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coll - column 

ep2 - end of mark: pointer to text element cb, 

eel 2 - column 

name - mark naKse 

id - mark id 

changed - flag to indicate mark changed 

markcommand - command to run when the activemark Is activated 



menuMarkCoiamand - description of the activomark ocoanand 
markv - list of mark visibility cb's 

pfnMarkEx.it ■ notification entry point to be called on mark-changed and mark- 
deleted events for unnamed marks (set via an Application Program Interface, i.e. 
API , call) 



When the visibility attributes of a mark are changed from the default text display- 
attributes in a particular edit view, a mark visibility control block, with the new settings for this view 
is chained off the mark control block (cb). The mark visibility control block takes the following 
form: 



mark visibility 



next - pointer to the. next mark visibility node in the list 

view - pointer to the edit view cb 

included - mark's text is explicitly included in the view 
excluded - mark's text is excluded from the edit view- 
highlighted - mark's display is highlighted in the edit view 

font " implementation- ■ specific aggregate of: sari; oispi&v attributes in an 

edit view; 

- font, font style and effects. 
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- background and foreground colours, 

- border style, 

- owner draw (presentation label is under external -command control) 

- presentation label to be displayed instead of the mark's 
associated text range: text, or bitmap/icon handle 

- relative/absolute location in the window when mark not displayed 
as part of the document text streasr:. 



In a linked-iist of marks, a isode is defined by a mark list data structure or control 
1 0 block which has the following form: 



next 
1 5 mark 



pointer to the next node in the mark list 
• pointer to the mark cb. 



In the document control block, the mark-related information is contained in the 
following variables: 



marklist 

markChangedP«odi n$ 



markDelecedPending 



irkDeletedCcw^nd 



markChan.gedCoiJBr.and 



mark list for the document 
mark list of changed marks pending 

notification 
mark list of deleted marks pending 

notification 
command to be called for named marks 

removed front this document 
command to be called for named marks 

changed in this doeuuusnt 
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lastMarkld - id of last -set unnamed mark 

runningMarks - recursion depth of running activemarks 

When a new edit view is opened for a document, the new view inherits all the mark 
visibility characteristics and attributes (markv control block) of the originating edit view. The niark- 
rdaied information in the view control is contained in the following variables: 



VIEW CONTROL BLOCK mark- related information 

filterMarks - true - consider mark include/exclude setting© in this edit view 

(see the MARKS' parameter) 
includedMarkB - there is at least one explicitly included mark in the edit 

view 



There are several edit system commands and parameters for handling marks as will 
be described in more detail below. 

Certain commands have equivalent API (Application Programming Interface) 
function calls, depending on the implementation requirements or performance characteristics of the 
edit system incorporating the activemarks mechanism according to the present invention. While 
most API functions will consist of faster paths to the mark-handling commands indicated below, 
some additional functionality may be defined for the programming interface. For example, the 
display attributes of an activernark consist of several parameters, which are more suitable to be 
passed in via an API function call through an appropriate data structure (control block). 
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An external command, such as a live parser, will mostly use unnamed marks through 
the API, being provided access to the mark control block via a handle. Such a parser will set all its 
activemarks in the document, set up each mark's command to call the parser back with the 
appropriate parameters, and register the desired notifications on aetivemark text changes and 
deletions. 

Now that an overview and functional aspects of the invention have been introduced 
and described, general pseudo code will be presented and described for functions and routines for 
implementing the aetivemark mechanism in an edit system 10 as described above. 

The MARK commands are used to set, clear, modify, etc. activemarks and 
conventions! marks, and run activemarks in the edit system 1 0. As will be described below, several 
parameters for the SET and GET editor commands are also utilized in the edit system 1 0 to handle 
marks. Other commands in the edit system 10 may optionally use or handle marks. For example, 
a navigational command, such as NEXT, may be used to advance the entry point to the next 
[activc]mark in the document. 

The MARK command is implemented as follows: 

INPUT : view - edit view cb 

parameters - the command: string (particular 
MAKX corsnand and parameters ? 

parse conwiandnams , marknarae, parameters 
document := view->document 

dispatch process according to cotBswaadnaiae (as will be described in more 
detail below; 
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The MARK SET command is used to set an activemark, or a conventional mark, in 
a document. The MARK SET command lakes the following form: 

MARK SET <markname> flinel [eolumnl Hine2 coluran2J]] 
Command scopes: document 

The MARK SET command assigns the specified <markname> to a certain position or text in the 
document. If not specified, the ending location for the mark is assumed to be the same as the starting 
location, if no location is specified, then current entry position is taken. If the specified 
<markname> is already being used, it is reassigned. The activemarks or marks can be either named 
by the user, or assigned an ID by the edit system 10. A special value of <marknarae> of the form 
# sets a mark that will be referenced by its ID, which has the form #n, where n is a positive integer. 
The ID of the iast mark created is queried using a command GET MARKID. For example, to create 
and use a mark referenced by its id, the following sequence of commands can be used: 

// create an aativemark cm lin-s 5, columns 3-9 
mark set It 5 3 5 9 

// get. its activemark id (e.g., returns; #123) 

get rnarkid. 

// set its command 

set markcemman<3. #123 mult ; edi tdic link % ,• edi tproc open % 
// run the activemark 
mark run 8123 

A feature of the activemark mechanism is that no change (such as tagging) is needed in the processed 
source file, nor its extended attributes, or in another file associated with it. All the functionality is 
handled by the live parser(s) manipulating the document via the activemarks mechanism. It will be 
understood that the live parsers) and/or associated editor tools can generate any or all of these if so 
desired by the specific application, such as addinj tj -equivalent tags to the saved source 
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document, or saving the activemarks in the file extended attributes or In a separate file for the nest 
edit session. The activemark mechanism is extensible and can handle documents of virtually any 
type. The MARK SET command is implemented as follows: 

epl ;~Q //document text element number linsT 
coll :-0 //coluranl 

ap2 :=0 //document text element, maabered line2 
col 2 :=0 //column2 

pMark :=cb of. Che mark identified by marknarcie 

in document ->marklist 
if pMisrk found // if mark already exists, re -set it 

setMark(view, pNark, epi, coll.. ep2, col 2} 
else // if a new mark, add it to the document 

addMcrk (view, markname, epl, coll, ep2, col 2} 

return 

'Die MARK FIND command is used to find a mark in the document, and takes the 
following form: 

MARK FIND <markname> 
Corranand scope; edit view 

It sets the entry position to that noted by the specified <markname>. The MARK FIND command 
is implemented, as follows; 

pMark ;= cb [control block) of the mark identified by 

markname in document ->markHst 
curaorpositioii := pMark->epl, pMark->coll 
redraw edit view ( CURSOR. JK5VKD) 
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The MARK CLEAR command is used to clear a specified activemark or mark (i.e. 
<markriame>X and takes the following ibnn: 

mark CLEAR <marfcnarae> 
Command, scope; dcc-jir,ent 

The specified mark is cleared and removed from ali ihe marklists of the text elements associated with 
the mark. A mark-deleted notification is then issued. The visibility of one or mors edit views may 
change as a result. The MARK CLEAR command is implemented as follows: 

pKark:= cb of the mark identified by raarknama 

i a doeumsin t - >mark list 
if pfferk found 

if pMark->epI i- null 

raarkdeleted (document, pKark} 
c 1 ea rMark (pMark ) 

for ail aiarkv data structures chained off pMark 
if xnarkv-> included = true 

t reeMark ( document, pMark) 
roarkTriggerExits [view; 

return 

The MARK INCLUDE command is provided for making She selected mark visible 
and the MARK EXCLUDE command is provided for making a mark not visible. The MARK 
INCLUDE/MARK EXCLUDE commands take the following form: 

MARK INCLUDE <marknair.e> fOSJ/QFF} 
MARK EXCLUDE «ma rkname> [CN/OFF] 
Command scope: edit view 
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The selected activemark is made visible, i.e. exclusively displayed, in the edit view according So 
conceptual relatedness, e.g. type of activemark, or by originating parser when several live parsers 
are attached simultaneously to the same document. When one or more marks are INCLUDE'd in 
an edit view, only the text ranges or labels of these marks are displayed. The text for m 
EXCLUDE 'd mark text is not displayed in the current edit view, The MARK INCLUDE/MARK 
EXCLUDE commands are implemented as follows: 

rnarkv := gatMarkV(view, marknsjns} 
if INCLUDE 

markv- included := ON/OFF 

if ON 

view->included*arks :™ vrv.e 

else 

cheeklncludeMark (view) 

else 

markv-> excluded := OK/OFF 

redraw edit view (VIEW_CHANGED) 
return 

The MARK SETFONT command is provided to associate display attributes with the 
mark, in order to highlight it in the edit view. The MARK SETFONT takes the form: 

MARK SETFONT <markname> [<font>) 
< i land scope: edit view 

The parameter <font> is an aggregate of display attributes, which is implementation-specific and 
platform-specific, if not specified, the mark is unhighlighted, i.e. the display attributes of its text 
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range are restored to those of the regular text in the particular edit view. The MARK SETFQNT 
command Is implemented as follows: 

markv x- getMarkV (view, markname) 
if no font 

markv ->high.ligh ted ;= false 

else 

markv ->font :<* font 
3tiarkv->highlighted := true 
if markv- >highligh ted changed or original markv- >fontl=font 
redraw edit view (VIEW_CHAKGED) 

return 

The MARK RUN command is provided to activate an activemark, which involves 
running the command® associated with the particular activemark. The MARK RUN command 
takes the following form: 

MASK RON E<markname>] 
Command scope; document 

If no <markname> is specified, the Im mark created is taken. To prevent infinite recursion by one 
activemark running other activemarks, being called back, and so on indefinitely, a certain maximum 
call depth is set. The activemark name is appended to the end of the command string (for 
identification), and the command is invoked. 

The editor or live parser profile will commonly hind a key, key combination, or 
mouse action, such as the Mt mouse button single click, to a generic activemark trigger command 
or editor macro, which will handle the activemark activations for a document in a consistent manner. 
An explicit command request, such as from a menu puil-down, from a tool or parser calls the same 



21 



CA 92246920 1998-69-10 



CA9-98-01J 

aciivemark trigger. The aciivemark trigger searches for the activemark(s) at the current entry point 
and runs the associated eommand(s). Where there are overlapping marks at the active entry point, 
the most appropriate action is taken to either invoke the command of the most specific aciivemark 
(that spanning the smallest text range), or invoke the commands of all the activemarks at that 
location in a certain order, or present the user with a choice. When MARK RUN is invoked, the 
activemark command first modifies the mark's highlight for visual-feedback purposes, and then 
performs the rest of the operations associated with the mark. The MARK RUN command is 
implemented as follows: 

if no Enarkrtame 

inarktiame := "it" + documeftl->lasiMarkld 
pM»rk := cb of the ;jiark identified by raarfcnaroe 

in doc.'viraent->mark!ist 
ii>Mark->roark€ommand '-mil 

!f d<wument->runningMarks < maxinsimiRuiftfimglvlarks 
mcrenieni document->ra«ais)gMarks 
edito!€on\rtsaJSd(view, tnarkCommand + " " ■;• Wiarknarce) 
decrewersl dacument->w»ningMarks 

The SET command sets, and the GET command queries, a particular edit system 
pararneier. Depending on the specific edit system, these editor settings for manipulating marks can 
be implemented as separate commands or additio nal options to the MARK command detailed above. 
The SET MARKS ON/OFF command takes the following foam 

SET MARKS OK/OFF 
Parameter scope: edit view 

The SET MARKS ON/OFF command activates/deactivates the interpretation of MARKING LUD E 
and MARKEXCLUDE settings for visibility purposes in the edit view, When the setting is 
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modified, the view is redrawn accordingly. The edit view draw functions consider this setting for 
purposes of including/excluding certain marks from the display. The SET MARKS ON/OFF 
command is implemented as follows: 

edit view's filterMarks := OH/OFF 
5 redraw edit, view (VI EXCHANGED) . 

The command GET MARK is provided for returning the current setting of the 
MARKS parameter, and takes the following form: 

GET MARKS 

10 Parameter scope: edit view 

Hie GET MARK S command is implemented as follows: 
return edit view's filterMarks 

The GET MARKINCLUDE/MARKEXCLUDE commands return the visibility of 
a mark as set with the MARK INCLUDE/EXCLUDE commands, and takes the form: 

15 GET MARKINCLUDE.f<markname>) 

GET MARKEXCLUDE [<markn ime>] 
Parameters scops: edit view 

The GET MARKINCLUDE/MARKEXCLUDE commands are implemented as follows: 
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if no markname 
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in documetrt->mark]ist 
raarkv :- marfcv chained offpMark for current edit view 
if rrsarkv fourscl 

return mark v->i nc luded/markv->exe3uded. 

The command GET MARKFONT is provided to determine the current display 
attribute settings of a mark, and takes the following form: 

GET MARKFONT.[<rBMkname>3 
Parameter scope: edit view 

The GET MARKFON T command is implemented as follows: 

ifnomarknsme 

marknanie + document->h«M«*ld 
pMark :** cb of the mark identified by rnarktsame 
in document->markl!st 
marfcv := roarkv data sirucmre off pMark for current edis view 
if markv found 

return markv->font display attributes aggregate information. 

The command GET MARKID is provided to determine the ID of a specified mark. 
The GET MARKID command takes the following form: 

GET M ARKID.[<martcname>] 
Parameter scope: document 

To get the ID of a newly created mark, the <markname> parameter is not specified. The GET 
MARKID command is implemented as follows: 
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if no raarknarae 

marknamc ;= "#" + docunnem->iasfMarkicS 
pMark ~ cb of the mark identified by markname 

in docmnent->raariclis{ 
if pMark found 

return "S* + pMark->id. 

The command SET MARKCOMMAND is provided to set the command binding of 
a mark in the document, turning the regular mark into an activemark, and the. GET 
MARKCOMMAND is provided to get the command(s) bound to an activemark. These commands 
take the following form: 

SET MARKCOMMAND.[<markname>I [command [parameters]] 
GET MARKCOMMAND,[<raarkname>] 
Parameter scope: activemark 

Once the command string is set for an activemark, the existing or pre-set command string may be 
queried, altered as needed, and set back for the activemark by another external editor utility or 
parser. In this manner, several commands may be chained off one activemark. If no command string 
is passed for SET MARKCOMMAND, the activemark is disabled and restored to a regular mark. 
The SET/GET MARKCOMMAND commands are implemented as follows: 

if no markname 

markname := "ft" + docume«t->fastMarkld 
pMark r= cb of the mark identified by markname 
in docuu!ent->markIist 
ser/reter!] pM8rk->markCom matid 
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The commands SET MENUMARKCOMMAND and GET 
MENUMARKCOMMAND are provided for setting arid getting a menu item string describing the 
acti vemark command which is to be added on a pop-up menu (for example, pop-up menu 1 07 shown 
in Fig. 5} for an edit window for a user-activated activemark. command. These commands take the 
folio wing form: 

SETMENUMARKCOMMAND.[<rasri!Jname>}[tnenuJ 
OETMENUMARKCOMMAND.[<mnknanie>] 
Parameter scope: activemark 

The SET MENUMARKCOMMAND command is particularly useful in situations where there are 
several overlapping marks, Alternatively, this command string may be used as "flyover" help, 

if no markname 

markname "#" + document->lastMarkid 
pMark :™ cb of the mark identified by markname 

in document->mark!ist 
set/return pMark->menuMarkCommand 

If no command string is passed for SET MENUMARKCOMMAND, the string is cleared. 

The commands SET MARKDELETEDE30T and GET MARKDELETEDEXIT are 
provided to set and get the command to be called upon removal of marks in the document. The 
commands take the following form: 

SET MARKDELETEDEXIT command [parameters] 
GET MARKDELETEDEXIT 
Parameter scope: document 
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The commands are implemented as follows: 

set/return document-^markDeletedCommanti 

A mark is removed by the MA.RK CLEAR command, or as text is deleted from the document. 

The commands SET MARKCHANGEDEXfT and GET MARKC H ANGEDEX! T 
5 , are provided lo set and get the command to be called when the text associated with a mark in the 
document is first changed. These commands take the following form; 

SE T MARKCHANGEDEXfT command [parameters] 
GET MARKCHANGEDEXIT 
Parameter scope: document 

1 0 The SET MARKCHANGEDEXIT and GET MARKCHANGEDEXIT commands are implemented 
as follows: 

set/return docutnent^rfiarkChangedCoraniaud 

The command GET MARKLIST is provided for retrieving a list of the named marks 
set in the document. The command takes the following form: 

15 GET MARKLIST 

Parameter scope: document 

The GET MARKLIST command is implemented as follows: 

string = 
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for all marks in document->marklist 

sfmark->name!=null 

string:^ siring * mark->na)«et-" " 
return string 

5 The command GET MARKRANGE is provided to retrieve the text range, i.e. starting 

and ending positions, of the specified mark. The command takes the following form: 

GET M A RK RANG E.[<markname>] 
Parameter scope: document 

The GET MARKRANGE command is implemented as follows: 

10 if no maitaiame 

maricnamc:="#"-idoe:u!neiTt->lastMarkl<l 

pMark ~ cb of the mar ti by markna 

in documttit->rttBrklisi 
recura spring composed of 
1 5 0/pMark->ep i ->eIementNumber, 

pMark->coll, 

iVpMa;-k->cs)2- i t'k-ineriiNL;fnber. 
pMark->ooi2. 

The following MARK-processing routines are called by the MARK command, by 
20 the SET/GET commands for mark parameters, by mark-handling API (Application Programming 
interface) functions, and by other mark -processing commands in the edit system 10, 
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The getMarkV routine retrieves the visibility aggregate of a mark for a particular edit 
view. If a visibility aggregate is not found for die specified view, then one is created. The 
getMarkV routine is implemented as follows: 

rNPUT:view - edit view cb 
5 marknaroe - mark name 

pMarfc?* cb of the mark ideatifiaii by marknatne 

in docurnent->markl>st 
for a!! markv data structures chained off pMark 

locate markv for this view (mafkv->view=view) 

10 if none found 

create a new one 
clear it 
link it in 
return markv 

1 5 The markChange routine Is provided to update the active-marks of a text element as 

a result of text alterations. The markChange routine is implemented as follows: 

INPUT:vkw - edit view cb 

ep - test element changed 
coi - starting column change 
20 3en - length of change 

changetype - replace, insert, or delete 

document; » view->document 

for ali marks in the text element ep marklist 
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update mark structure depending on type of change, its range, and the range covered by the mark 



(starting test clement, ending text element, and range of characters in the current text 
element) 



5 



if whole mark delete/deleted from text element ep 

remove mark node from text element Eist & free it 



if whole 



fk deli ie 



SO 



markDeletedNotification(dc u lark) 
for all markv data structures chained off pMark 
check! ncludeMark(markv->view) 
eiss if (mark changed) 



markChangedNotification{doeufnent,pM8rk) 
markTriggerExits<viaw) 

The markChaage routine is called by the text processing module 1 2 (Fig. 1) to handle activemarks 
affected by text operations. For wider-scope actions, i.e., those spanning several text elements, for 

1 5 example, a block delete operation, the markChange routine is called for each text element which is 
altered. As a result of the text edit operation, one or more mark(s) may have their range shifted, their 
text may have been altered, or mark(s) may have been completely removed. Accordingly, 
appropriate mark notifications are issued. The visibility of one or more edit views may also change 
as a result. When text elements are joined or split, the marks associated with these text elements are 

20 updated, and duplicates in the mark lists resulting from the operation are pruned. 

The routine markDeletedNotification is provided for adding a specified mark to the 
document mark-deleted notifications pending list. The markDeletedNotification routine is 
implemented as follows: 
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INPUT: document - document cb (control bloek) 
pMark - pointer to cb of deleted mark 
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find mark in document 
if found 

unlink mark cb from dceumeni>>markh'si 

eise 

5 a! locate & copy a mark cb 

link mark cb in documcnt->markDel( I i 

The routine markChangedNotification is provided for adding a specified mark, if not 
yet changed, to the document mark-changed notifications pending list. The 
markChangedNotification routine is implemented as follows: 

10 INPUT; document - document cb 

pMark - pointer to cb of altered mark 

if p Mark->c-hsrtged == fa lag 

pMark->changed:«truc 
allocate Sl copy a mark cb 
3 5 link reaark cb in documetii->m£(kChafigedPs;!dmg list 

The routine markTriggerExits is provided for triggering the mark changed and mark 
deleted notification commands for ail the marks in the document mark notification pending lists. 
The markTriggerExits routine is implemented as follows: 

INPUT: view - edit view cb 

20 document:=view->d«;«iment 

pMarkList:=docamertt->RiarkCbdngedPending 
documen(->markChangedPcndEng:>=nuH 
for all nodes in pMarkList 

pM ark:=pM arkList->mark 
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if pMarR->name!-niiH 
ifdocument->markChangBdC(Mnmand!-nulJ 
markExit(vtew, documer i->ma kChaiigec: Ma 
eise 

if pMaric->pftiMarkExit!=null 
nottfyActivemark(documsirt, pMark->pfhMarkExli, 
EX1TJVJARKCHANGED, pMark} 
remove & free mark node from pJvferkList 

pMarkUst:=docament->markDeletedPending 
dce«ment->jnarkDe]etedPending— nisiJ 
for all nodes in pMatkList 

pMark:=-pMafkList->mark 



if documefit->markDeietedCommand!=nut! 
markExit{vjew,documcnt->jnaricDeleeedCommand, pMark-rtame) 

" - - - ^ . 'M 

notify Activemark(document, pMark->ptnN4arkExit, 
EX !T . MA RKDELETED, pMark) 
free ail pMark->maitv data structures 
free pMark 

remove & free its nods from pMarkList 

The markTriggerExits routine is called by the MARK CLEAR command, and upon text editing 
operations. For all the named marks in the document mark pending lists, any registered mark- 
changed/mark-deleted command is called; for the unnamed marks in the lists, any registered entry- 
point is called with the mark-changed/mark-deleted event notification. 
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The routine markExit is provided for appending the markname to the end of the 
command string for identification, and for invoking the command. The markExit routine is 
implemented as follows: 

INPUT: view - edit view cb 
S command - mark command registered 

markname - mark name 

if command NnuJI and markname J=nu]l 

editQrCommand{view,«mmman<B-" "+markname) 

Hie routine checklncludeMatk is provided for checking if there are any marks left 
10 with the INCLUDE flag set. If there are no such marks left, the includedMarks flag is reset in the 
edit view cb, so that all the text elements are displayed upon edit view redraw. The 
chcckJncludeMark routine is implemented as follows: 

INPUT: view - edit view cb 

if view->includedMarks = false 
1 5 return 

for at! view->document->marktist nodes 

for sl\ misrk!ist->mark->markv data structures 

if marSiv->view=yiew and markv->included « true 
return 

20 view->inciudedMarks := false 

redraw edit view (V1EW CHANGBD) 
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The routine clearMark is provided for disassociating a mark from its text. The 
clearMark routine is implemented as fallows: 

INPUT; pMark - pointer to mark cb 

if pMark->epl - null 
5 return 

for all elements associated with murk (pMark->epf .. pMark->ep2) 
find list node for pMark in the iaxn ki ier»! >■: i fclis! 
if found 

remove & free nods from the text element markiist 

10 pMark->epi :=nul! 

pMark->sp2 := null 
pMark->cc!I : - 0 
pMark->oo!2 :-0 
pMark->chartged:- false 

1 5 for all markv data structures chained offpMsrk 

if markY->highIig!ited - true 

redraw edit view (VIEW ^CHANGED). 

The clearMark routine removes the mark from all the marklists of the text elements associated with 
the mark, and clears the mark, The edit views in which the mark was highlighted are scheduled for 
20 redraw. 

The routine freeMark is provided for freeing the storage associated with a mark, and 
removing it from the document list. 
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INPUT: document - document eb 

pMark - pointer to mark cb 

ifpMark->ep! != null 

CiearMark(pMark) 

5 find SisI node whose mark = ptvbrk in documer,i->marklist 

if found 

remove & free nods from doeumersi->markiist 
free ai! markv data structures chained off pMark 
free pMark 

1 0 The freeMark routine disassociates the mark from its current text, and then removes the mark from 
the document markiist and its associate memory is freed. 

The routine setMark is provided for adding a mark to the marklists of all the text 
elements that are associated with it. 

INPUT; view - edit view cb 
1 5 pMark - pointer to a mark sb . 

ep! - starting text element 
coll - starling column 
ep2 - ending text clement 
co!2 - ending column 

20 ifpMaric-Xspl i-oull 

efearMsrk(pMark) 

Eiocument:=view->dacumen£ 

//text elements were specified 

35 
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if epi Nr.dl arsd ep2!=™i§ 

if order of ep I , ep2 not ascending 
swap them 

if order of call, call m a single-clement mark no: ascending swap them 

5 //determine starting and ending positions: 

/Aif no starting element specified, use current entry point 

epl —visw->ep 
col 1 :=view->cursorPosition 
10 ep2 :-null 

//-if no ending tsxc element specified, use start of mark 
if ep2=nuil 

ep2 ;-epi 

35 pMark»epI :=epl 

pMark->ep2 :~ep2 
pMark->co!i :=coli 
2 ,--co!2 
£»Mark->d)aug6d"fa!se 

20 for ail the text sleme-ms associated v/ith the mark (spl ..ep2) 

allocate a marklist nade (pMarkList) 
pMarkList->mark.:==pMark 
link it in at end of the text element marklist 

If the mark is being re-set, the setMark routine first disassociates the mark from its previous text, 
25 The range of text associated with the mark is established based on the input parameters, and then the 
sctMark routine adds the mark to the markiisfs of all the text elements in this range. 
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The routine addMark is provided for adding a mark to a document. The addMark 
routine is implemented as follows: 

SNPUT: view - edit view eb 

marknama - mark name (for a named mark) 
5 epl - starting text element 

col! - starring comma 
ep2 - ending text element 
col2 > ending column 
OUTPUT: pointsr to the new mark cb 

1 0 allocate mark cb (pMsrk) 

initialize mark cb 

allocate rnarklist nods (pMarkList) pointing to pMark 
document:""vjew->do«jment 

//assign id to the mark 
15 Increment document->iastMarkld 

pM3rk->id; : =document>las'tMarkId 
if markaame^ "#" 

markname:» + document---!; tM kid 
pM ark->t5am e :=]7iarkn am? 

20 link in node pMarkList in document->marklis! 

setMark(view. pMark, epl, coil, ep2, coJ2) 
return pMark 

The addMark routine allocates the mark cb (control block) and initializes the mark cb based on the 
input parameters. The addxnark routine then adds the mark cb to the raarklists of fee document and 
25 the text elements associated with it. 
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The routine dispIayMarks is provided for handling the display of the marks during 
the screen build and paint update in the edit view. It will be appreciated that the dispIayMarks 
routine is implementation-specific and platform-specific, and the particulars of the routine will 
depend on the mark display features supported, the paint procedures employed, etc, In the 
5 implementation of the dispIayMarks routines, the various visibility and display attributes of the 
marks in the edit view for the update regions being painted are taken into consideration, including 
the following: 



- vicw-HiterMarks for the included/excluded marks 

- the display attributes aggregate of each mark in the view 
1 0 where matk">ffiarkv->high lighted is true: 

- font, font style and effects, foreground and background colours, border style for displaying the lext 
associated with the mark, or 

- the overriding presentation label, displayed instead of the mark's associated text range: text, or 
bitmap/icon 

1 5 - the relative/absolute location in the window when the mark is not displayed as part of the document 

text stream; e.g„ aligned vertically within the edit area or the start/end margin of the view 

- when the acrivemark label is displayed under the contra! of an external command (owner-drawn), 
the appropriate draw- request notifications are sent to the external command. 



The routine initialize MarksPopup is provided for initializing the edit window popup 
20 with the menu items pertaining to any activemarks at Che current entry point. The 
initiaiizeMarksPopup routine is implemented as follows: 



ep:=current text element 

for ail marks if. the text element ep marklist 

if mark test range covers cursorPosisktts 
25 add a popup menu item mark->menuMarkCoRirn8r)d 
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In the case of several activemarks at the current entry point, the menu items may be added to the 
pop-up in a certain sorted order. The pop-up menu item ID for the user selection identifies the user 
choice, and is used to activate the appropriate activemark. 

Next, implementation details for the commands/macro interface module 15 (Fig. 1) 
5 are considered. The commands/macro module i5 controls the interface to internal commands, 
external commands (e.g. C/C++ f lava,- written utilities) and editor macros (e.g. REXX- written or 
automatically generated by the keystroke-recorder), including live (incremental) parsers. The 
commands/macro module 15 loads, runs, and unloads external commands and macros. 

Commands may be invoked in the edit system 1 0 by a user through a command line, 
10 from within macros and externa! commands (e.g. from a live parser in response to changes to the 
document test}, upon other events being set such as notifications of changed/deleted activemarks, 
or upon the activation of an activemark (i.e. invocation of an activemark command). It will be 
appreciated that certain API (Application Programming Interface) functions may provide faster paths 
to the same functionality. 

1 5 The command/macro module 1 5 parses a command string for the command name and 

its arguments. The command name is looked up to determine the location of the command; the API- 
registration of notifications for the change/deletion of an activemark may specify an entry point 
(callback) into the external-command utility that handles it (usually the one that created the 
activemark), which will be invoked at these junctures. 

20 Invocation of a mark notification and activemark command causes the mark name 

to be appended to the command arguments string, or provides the activemark handle (i.e. a pointer 
to the mark control block), for purposes of identifying the event source. 
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line processing performed by the Commands/Macros interface 15 Includes: (a) 
internal editor commands, and (b) external commands, The internal commands-processing 
comprises synonyms (aliases) resolution; internal editor command lookup; implicit SET/GET of 
editor parameters; and loading of editor macros. The external commands-processing comprises 
5 loading & unloading (releasing) of editor external command dynamic-link libraries (DLL's) or 
shared libraries, and loading and releasing of a Java Virtual Machine (JVM) and the external 
command Java classes and objects; initialization of the external command, running it with the 
arguments supplied, sending it notifications of a new document being loaded in the editor, of exiting 
a document, and of the termination of the editor, termination Sc unloading of the external command 
10 upon editor exit, or certain signals and exceptions; and invocation of system commands (through a 
command shell). 

The command/macro interface 15 also includes the editor API (Application 
Programming Interface) for the external commands to interact with the editor, such as get and set 
of editor parameters, invocation of commands, registration of notifications, memory management. 

15 The command/macro interface 15 maintains a list of external-command control 

blocks. Each control block (cb) includes the name of the external command, handles to its DLL 
(Dynamic Link Library) and to its entry points, handles to its registered callbacks, the type of the 
external command and the interface it adheres to. The external-command cb list is also used for 
catching exceptions in the external command, including logging, graceful termination, unloading 

20 of the offending external command. 

The command/macro interface 15 includes: an extemalCommand function, a 
notifyActivemark function, a notify DocExit function and a commandExit function. 
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The ejctemalCommand function is invoked when a command is not found in the 
internal editor command lables, or as an implicit SET/GET editor parameter, or as as editor macro. 
The extemalCommand function is implemented as follows: 



INPUT: name - command name string 

arguments - command arguments String 



if not found in the existing external-command efa list, 

find & load dynamic link library (DLL) named as specified determine interface type by entry points 

exported from the DLL, and, similarly, exported notification entry points (if any) 

create external-command cb and add to list 
for non-Java editors, a secondary command processor handles 

Java externa! commands - instantiate the JVM, Look for the classes) required, initialize them, etc- 
additional information regarding the execution of the external 

command may be specified, sash as the type of execution from a secondary thread, etc. 
allocate a user data area in the context of the document 
if first invocation, 

first send external-command initialization ratification/can" externa* command initialization entry point 
call the external command with any specified arguments. 



The notify Activsmark function calls an API-registered activemark changed/deleted 
notification entry point in an external command. The noUfyActivemark function is implemented as 
follows: 



INPUT: document - document cb 

pfhNofity - entry point to call 

notification - type of went: £XIT_MAR.KCHANGEQf* 

EXITMARKDELETED 
pMark - pointer to mark cb 
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build a document-context control block 
cail the external-command entry point pmNotlfy with the 
type of event, and the mark handle (pMark) 

The notifyDocExit function is invoked upon termination of a document in the editor 
5 to notify ail the external commands that have registered to be notified of document terminations. 
The notifyDocExit function is implemented as follows: 

INPUT: dacumefiE - documem cb 
build a document-context control block 

cursor through she external-command cb list for externa! commands thsE 
10 - are implicitly defined to receive document-termination notifications, and 

- those that have registered a document-termination entry point 
send the docyrnenl-tefrriinaiion notificatlon/caH the documaiMerrmsssitio!! entry point. 

The commandExit function is used to terminate and unlink a specified external 
command. The commandExit function is called for all the externa! commands in the extemal- 
i 5 command cb list when the editor terminates. The eommsndExii function is implemented as follows: 

INPUT: sjitsmaiComntaiid - name of the editor externa) command 

build a document-context control block 

send an external-command terminate notifieaEiort/call the 

external command termination entry point 
20 release (i.e. unlink) the DLL, or 

destroy the Java external command object and release the JVM upon termination of ail Java external 

commands 

remove !he external-con; mar.d eb from the maintained lis 
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The disclosed invention as embodied in a method, computer system and computer 
program product, is particularly applicable to the IBM live parsing extensible editor (LPEX) 
environment. Those skilled in the relevant art will appreciate that the invention is suitable and 
relevant to various computer system environments, which are appropriately programmed in 
accordance with the features described. 
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The embodiments of the invention in which an exclusive property or privilege is claimed are defined 
as follows: 

11, A processing system for processing a document, said processing system comprising: 

2 (g) a programmable text processing module having means for loading the 

3 document and a parsing editor for initially parsingthe document and thereafter incrementally parsing 

4 changes committed in said document; 

5 (b) a mark control module having means for setting a plurality of marks in the 

6 document, means for modifying said marks, and means for clearing said marks, and each of said 

7 marks comprising selected information in the document and means for linking said selected 

8 information with a command, said linking means being responsive to the operation of said parsing 

9 editor; 

10 (c) a graphical user interface module having means for displaying the. document 

1 1 and means for controlling the dispky of the document; 

12 (d) an edit control module having means tor controlling said text processing 

1 3 module, means for controlling said mark control module, and means for controlling said graphical 

1 4 user interface module . 

1 2. The processing system as claimed in claim 1 , further including a command interface 

2 module, said command interface module comprising means for linking commands internal and 

3 external to said processing system to one or more selected marks. 

1 3, The processing system as claimed in claim 3 or 2, wherein said linking means 

2 includes means responsive to inputs entered by a user through said graphical user interface for 

3 activating a command linked with said selected information. 
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1 4. The processing system as claimed in claim 1, wherein said mark control module 

2 includes means for changing the appearance of said mark in said document in response to activation 

3 of said mark. 

1 s, in a document processing system having means for loading and storing a document, 

2 a parsing editor for initially parsing the document and thereafter incrementally parsing information 

3 entered in the document, and a graphical user interface for displaying the document, a mechanism 

4 for an activemark comprising: 

5 (a) selected information in the document; 

g (b) means for binding a command to said selected information; 

7 ( C ) said means for binding being responsive to the operation of said parsing 

8 editor, and the activemark being created as said parsing editor parses the document. 

1 6. The activemark mechanism as claimed in claim 5, further including means for 

2 modifying the appearance of said selected information in the document being displayed in response 

3 to activation of said activemark. 

1 7, in a document processing system having means for loading and storing a document, 

2 a parsing editor for initially parsing the document and thereafter incrementally parsing information 

3 entered in the document, and a graphical user interface for displaying the document, a method for 

4 generating marks in the document, said method comprising the steps of: 

5 (a) selecting information for a mark in the document; 

6 (b) linking said selected information to a command, said linking operation being 

7 responsive to the parsing by the parsing editor; 

8 (c) activating said mark in response to an activation input. 
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9 8. The method as claimed in claim 7, wherein said coarniand comprises a command 

1 0 internal to the processing system, 

1 9, The method as claimed in claim 7, wherein said command comprises a command 

2 external to the processing system. 

1 10, The method as claimed in claim 7, further including the step of altering the 

2 appearance of said acti vemark in the document in response to activation of said activemark. 

1 n. Data storage media recorded with a computer program which, in combination with 

2 a general purpose computer loaded with an operating system and a parsing editor, equipped to read 

3 into memory and execute program data from Ehe data storage media, constituting a method in 

4 accordance with any of the claims 7, 8, 9 or 1 0. 
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/» lxxqusrO */ / 
char* Ixxqusr {cTiar* iteo, ctiar* buff) 




/* iKxqnumO */ * 




int lxxqnun (char» itera) 




/• setup() •/ 




int setup () 




/* lxexifcQ */ 

i»t lxexit (chat-* par*!) 




/» lx«ain() •/ 

int lx»win (ch*r* parameters) 




/»■ loatifilllatslesO */ 

int loadfillTables (char* filename) 




/* loadable »/ 

int loadTable (char** table, RLE* file) 




/» getLine(> *{ 

char* getLine {FILE* file) 




/" parsecur rentQ »/ 
int parseCurrent {) 




j/« pafs«Elenent() »/ 
int parseElMerst {) 




/* reatfCenprentO */ 

int rsfadCastssnt (int pes) 




/-* ruadlayotitO */ 

int rsadLayout (int pss) 




V readLiteralO */ 

int readLiteral <int pos) 




/* readHtMberC) */ 

lot readNureber <if!t pes) 




readVordQ */ 
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]7* p3rse¥arf«rt() *f ' 
lint parseSurrent O 



/* inside consent if previous ?jas open eonstefnt *J 
if {IxprsuO — 8) { 

insideCcnnent - isapcnCocmcnt( ) ; 

lxnextC); 



/* p.ars<? starting elfRfnt */ 
liuol uascorament - is0penCOBRent<) ; 
int rc - pai-seElewcitO; 
IF (rc < 8) 
return rc; 

/« parse the rest «f a conneat «/ 

wnile ({uascuniwnt insideficnjH«fit) S& IxaeastO ="» 8) < 
wascomsjit =» isOpenConnentO: 
if {(rc » parceEienentO) < 6) 
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